home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 24 / Mac Magazin and MacEasy Magazine CD - Issue 24.iso / Utilities / Coffee Timer 1.0.1 FAT / Coffee Timer / Coffee Timer.rsrc / TEXT_5000.txt < prev    next >
Text File  |  1996-07-03  |  8KB  |  89 lines

  1.  
  2.                       Coffee Timer documentation
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  Version 1.0.1                                                                                                      July 1996 
  10.  
  11. ¬©1996 Alessandro Levi Montalcini   Technical support, permissions, suggestions:
  12. C.so Re Umberto 10                          Internet email: alm@torino.alpcom.it
  13. 10121 Torino                                   ftp://ftp.alpcom.it/software/mac/LMontalcini
  14. Italy                                                ftp://ftp.alpcom.it/software/mac/LMontalcini/alm.html
  15.  
  16. Binary Software, Inc.                       Orders and registrations only:
  17. 2118 Wilshire Blvd Suite 900           Phone: (800) 8-BINARY (824-6279)
  18. Santa Monica, CA 90403                   or: (310) 449-1481
  19. United States of America                   Fax: (800) 555-7217 or (310) 449-1473
  20.                                                         Internet email: sales@binarysoft.com
  21.                                                         CompuServe email: 74220,3377
  22.                                                         America Online email: BINARY SW
  23.                                                         ftp://users.aol.com/binarysw/
  24.                                                                                                                                             
  25.  
  26. ‚Ä¢ Shareware: $10
  27. ‚óä  This program is distributed as shareware: if you use it please honor the shareware system by sending $10 U.S. to Binary Software at the address above. You can email, fax, snail-mail, or call. When registering please specify the name and version of this program as well as your name, mailing address, email address, phone number, fax number, and your credit card number and expiration date (we accept Visa, MasterCard, American Express, and Discover). You can also pay with a check, money order, or cash.
  28. ‚óä  Binary Software is only collecting the registrations on my behalf; please contact me directly by email for any information, suggestion, permission, or request about this software. If you want to send non-U.S. cash or any other material including software, books, magazines, CD-ROMs or any hardware, please send it to me at my Italian address. If you do so, however, you should also notify me by email because I only receive my snail mail once per month.
  29. ‚óä  If you can‚Äôt afford to register you may still want to send Binary Software your name, address and email address so they can send you new product announcements and other special offers.
  30. ‚óä  Site licenses and group discounts are available for 5 or more registrations. Please check my ftp site or send email for more information.
  31. ‚óä  Please register: your support is the only way for me to keep working on cool shareware programs.
  32.  
  33. ‚Ä¢ Introduction
  34. ‚óä  The Coffee Timer is a very simple countdown timer I built after frying my third coffee pot. Like many other programmers, I often drink coffe while working - I mean Italian expresso coffee, the kind you make with a ‚Äúmoka‚Äù coffee pot. However, I don‚Äôt usually wait for the coffee to be ready before going back to work, which often results in the coffee pot being forgotten on the fire for hours. This is a programmer‚Äôs solution to the problem: a simple countdown timer with a loud alarm and a couple of other useful options.
  35. ‚óä  For those of you who need more flexibility in their timer, the Coffee Timer allows a KeyQuencer macro to be run when the timer times out. This lets you instruct your Mac to do pretty much anything at alarm time. The Coffee Timer works with both KeyQuencer 1.2.x and the forthcoming KeyQuencer 2.0 (which you don‚Äôt want to miss!).
  36. ‚óä  Quite obviously, the Coffee Timer is not limited to your daily coffee break. You can use it to remind yourself of anything that must happen in the near future‚Ķ filling the bath tub? taking a short sleep? delaying a fax? Just launch the Coffee Timer and let it help your memory and your watch.
  37. ‚óä  You may even put an alias to Coffee Timer in your Startup Items folder to prevent yourself from sitting in front of your Mac for long periods of time. All you have to do is take a break every time the timer starts bugging you‚Ķ
  38.  
  39. ‚Ä¢ Instructions
  40. ‚óä  File menu:
  41.   - Close: closes the timer window.
  42.   - Quit: resets and quits the timer.
  43. ‚óä  Timer menu:
  44.   - Reset: resets the timer.
  45.   - Display: opens the timer window if it was closed.
  46.   - Configure: lets you change the name and duration of 10 different timer events.
  47.   - Timers 1...10: sets the timer to a specific duration. This does NOT reset the timer.
  48.   - Other‚Ķ: lets you quickly specify a timer duration without saving it in the one of the 10 timer events.
  49. ‚óä  Alarm menu:
  50.   - Show Timeout Message: shows a message when the timer times out.
  51.   - Play Alarm Sounds: plays alarm sounds when the timer times out.
  52.   - Keep Playing Forever: keeps playing forever instead of only playing 5 sounds.
  53.   - Full Speaker Volume: brings the speaker volume to its top level before playing. The volume is reset to its previous value when the Coffee Timer quits.
  54.   - Stop Playing: stops playing the alert sounds without resetting the timer.
  55.   - Run KeyQuencer Macro‚Ķ: runs a KeyQuencer macro when the timer times out. This requires the KeyQuencer macro engine to be installed (version 1.2.x or 2.0.x). You can leave the macro text field empty if you don‚Äôt want to run any macro. Note that the macro text should contain the actual macro, not the name of an installed macro.
  56.  
  57. ‚Ä¢ Technical notes
  58. ‚óä  The timer is based on the Mac‚Äôs internal clock. Its minimum time frame is 1 second, so don‚Äôt expect it to be more precise than that. Specifically, the first second after you reset the timer may be partially cut to align the counter to the Mac‚Äôs seconds counter.
  59.  
  60. ‚Ä¢ Compatibility notes
  61. ‚óä  PowerPC: Coffee Timer is a fat binary, containing both 680x0 and native PowerPC code.
  62. ‚óä  System 7 and later: Coffee Timer runs fine on any version of the Mac OS starting with 7.0.
  63. ‚óä  System 6: System 6 is fully supported by Coffee Timer, although the coffee pot icon is not drawn in the timer window.
  64.  
  65. ‚Ä¢ Distribution
  66. ‚óä  This software is ¬©1995-96 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and there‚Äôs no charge for it, but it may not be included in any commercial package without my consent.
  67. ‚óä  All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees.
  68. ‚óä  All non-profit user groups may distribute it at no charge.
  69. ‚óä  All magazines may publish it on floppy disk or CD-ROM without asking me first, as long as I get a copy of the issue containing my software.
  70. ‚óä  All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price.
  71. ‚óä  All redistribution companies such as Pacific HiTech, AMUG, Celestin or Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the company‚Äôs offerings (where applicable).
  72. ‚óä  You may find the latest version of all my shareware and freeware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The ALM Share and ALM Free packages, which contain most of my stuff and can be registered at a very low price, are also available there.
  73.  
  74. ‚Ä¢ Version history
  75. ‚óä  1.0.1 - Recompiled with CodeWarrior 9 and updated documentation.
  76. ‚óä  1.0 - First public release.
  77.  
  78. ‚Ä¢ Thanks to‚Ķ
  79. ‚óä  Valentina Pavia, who waited patiently until late at night;
  80. ‚óä  Alberto Ricci, for his beta-testing and suggestions;
  81. ‚óä  Fabrizio Oddone, for all his usual help;
  82. ‚óä  Masatsugu Nagata, for his invaluable beta testing of all my stuff;
  83. ‚óä  All those who registered for my other shareware; they are now way too many to be listed, but this program wouldn‚Äôt be here without them.
  84.  
  85. ‚Ä¢ Disclaimer
  86. ‚óä  This software should never cause any damage, but you‚Äôre using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it.
  87.  
  88. ‚Ä¢ Have fun!
  89. ‚óä  And don‚Äôt forget to register your shareware, so that more cool inexpensive utilities can see the light in the future.